home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 5 / Gold Medal Software - Volume 5 (Gold Medal) (1995).iso / music / midim100.arj / MIDIMAC.TXT < prev    next >
Text File  |  1994-11-15  |  19KB  |  616 lines
  1. MIDI Machine V1.00 (c) Excel Progs/TOW Development 1994
  2.  
  3. I.    Info about Excel Progs/TOW Development
  4. II.    Introduction
  5. III.    What You Need
  6. IV.    Running MIDI Machine
  7. V.    Configuring MIDI Machine
  8. VI.    Extra Animations
  9. VII.    Support Info.
  10. VIII.    Registering
  11. IX.    Revisions
  12. X.    Warranty/Disclaimer/Thanks
  13.  
  14. I.    Info about Excel Progs/Tow Development
  15.  
  16. MIDI Machine V1.00 by Excel Progs/TOW Development
  17.  
  18. MIDI Machine was written by Andrew Malek of Excel Progs, and is
  19. being distributed by Excel Progs and TOW Development.
  20.  
  21. For more information, contact Excel Progs at:
  22.  
  23. Excel Progs
  24. c/o Andrew Malek
  25. 434 Gallaher View Road Apt 60
  26. Knoxville, TN  37919
  27.  
  28. Or, contact either Excel Progs or TOW Development via The Other World
  29. BBS of Knoxville, TN.
  30.  
  31. TOW BBS:  (615)-577-9342, Games, No Ratio, More
  32.  
  33. II.    Introduction
  34.  
  35. Congratulations for choosing MIDI Machine as your MS-Windows(c) MIDI
  36. player!  Midi Machine is the latest of Excel Progs line of excellent
  37. products for the IBM(c)/clone computers, and like all EP products, it
  38. is backed by full support.
  39.  
  40. Midi Machine allows you to play the .MID (MIDI) files that are seen
  41. all throughout the world.  Midi Machine also allows you to play the
  42. standard .WAV (WAVEAUDIO) files. MIDIs cover all genres of music,
  43. including:
  44.  
  45. o       Big Band Jazz/Blues/Funk/New Age Jazz
  46. o       Hard Rock/Heavy Metal
  47. o    Pop Music/Rock 'N' Roll
  48. o       Easy Listening/Soft Rock
  49. o       Classical/Instrumental
  50.  
  51. and many more styles of music are represented by this music file
  52. format.  
  53.  
  54. WAVs cover all types of sounds, including:
  55.  
  56. o       Instrument Demonstrations
  57. o       Music Clippings
  58. o       Voice-Mail Attachments
  59. o       System Events
  60.  
  61. and many more types of sound files are represented by this audio
  62. file format.
  63.  
  64. III.    What you Need
  65.  
  66. In order to play music with Midi Machine, you must have:
  67.  
  68. o       MS-Windows 3.1 or higher
  69. o       A Midi-compatible sound card (GUS, SB, SBPro, TB,..etc)
  70. o       Installed MIDI drivers for Windows
  71. o       VBRUN300.DLL (found at many fine BBS's and distribution networks)
  72.  
  73. If you wish to only play WAV files, the midi drivers and midi-
  74. compliant sound card are not needed.  You will, however, need WAV
  75. support and drivers.
  76.  
  77. IV.    Running MIDI Machine
  78.  
  79. In order to run Midi Machine, you need to copy, unpack,..etc the files
  80. you received.  Next, copy the MCI.VBX and ANIBUTON.VBX files to your main 
  81. Windows directory.  Get VBRUN300.DLL from your distribution site (or The
  82. Other World BBS), and place it to your Windows directory.  Add the Midi
  83. Machine icon to your program manager or equivalent (or just run it
  84. straight using your pm's run command).
  85.  
  86. Midi Machine will execute and bring you up to the main status window.
  87. This window is divided into several parts:
  88.  
  89. o    Status Bar
  90.  
  91.     This bar displays the name of the song being played, the mode
  92.     of operation you are in, and other information (it CAN be
  93.     turned off...see "Configuring MIDI Machine.")
  94.  
  95. o    Info Bar
  96.         
  97.     This bar will contain file INFO on sound files when you request
  98.     it (see "Text Buttons")
  99.  
  100. o       Drive Selection Window
  101.  
  102.     This will allow you to choose which drive Midi Machine will
  103.     pull the Sound files from.
  104.  
  105. o       Directory Selection Window
  106.  
  107.     This will allow you to choose which directory from which
  108.     Midi Machine will pull the files or album files.
  109.  
  110. o       File Selection Window
  111.  
  112.     This will allow you to choose the individual sounds that you wish
  113.     to add to your playing queue (see below).  Or, when loading
  114.     albums, this is where you will select the album which contains
  115.     files to place in your queue.
  116.  
  117. o    Animation Box
  118.  
  119.     This box is located under the INFO BAR, and defaults to the EP
  120.     logo.  It will be replaced with an Icon-Animation when sounds
  121.     are being played if so desired (see "CONFIGURING MIDI
  122.     MACHINE").
  123.  
  124. o       Sound Playing queue
  125.  
  126.     This will be a list of Sounds that you have selected to play,
  127.     in order of selection (note that the order the Sound files are
  128.     selected are NOT exactly the order in which that they will be
  129.     played!  See below for more options).
  130.  
  131. o    Text Input Bar
  132.  
  133.     A text input region above the three file buttons (Rename, Delete,
  134.     and Info) that is used when performing various extended
  135.     functions (see "GRAPHIC BUTTONS").
  136.  
  137. o       Text Buttons
  138.  
  139.     Buttons are the method by which you can tell MIDI machine
  140.     what to do.  The text buttons are as follows:
  141.  
  142.     (R)ename
  143.  
  144.     Allows you to rename or move a sound when you are out of
  145.     playing mode.
  146.  
  147.     (D)elete
  148.  
  149.     Allows you to delete a sound when not in playing mode.
  150.  
  151.     (I)nfo
  152.  
  153.     Allows you to get information on a sound.  This information
  154.     will be displayed in the INFO BAR which is the second text
  155.     bar from the top.
  156.  
  157.     (A)dd
  158.  
  159.     Allows you to add a sound file from the file selection window
  160.     to your Sound playing queue.
  161.  
  162.     Add A(l)l
  163.  
  164.     Allows you to add ALL sound files from the file selection
  165.     window to your Sound playing queue.
  166.  
  167.     R(e)move
  168.  
  169.     Removes a sound or sounds from your playing queue.
  170.  
  171.     (C)lear
  172.  
  173.     Clears ALL sounds from the queue.
  174.  
  175.     A(b)out
  176.  
  177.     Information about Midi Machine, including the author, and
  178.     the person to whom this version of MIDI Machine is registered
  179.     to (if this is a registered version).
  180.  
  181.     E(x)it
  182.  
  183.     Exits Midi Machine or the current task if you are using one
  184.     of the graphical buttons (see "GRAPHIC BUTTONS").
  185.  
  186.     Set(u)p
  187.  
  188.     Goes into MIDI Machine configuration mode, where you can change
  189.     many options of the program's operation (see "CONFIGURING MIDI
  190.     MACHINE").
  191.  
  192.     (H)elp
  193.  
  194.     Displays help about Midi Machine.
  195.  
  196.     (S)tart
  197.  
  198.     Start playing sounds!  You must have sounds already in your
  199.     queue for this operation to work.
  200.  
  201.     (N)ext
  202.  
  203.     Skip to the next sound in your queue.
  204.  
  205.     S(T)OP!
  206.  
  207.     Abort all sounds.  Keeps any songs in the queue available for
  208.     playing.
  209.  
  210.     (P)ause/(P)lay
  211.  
  212.     This button changes depending upon the state of the sound.
  213.     You can temporarily pause the sound output and then resume
  214.     later.
  215.  
  216. o       Graphic Buttons
  217.  
  218.     The graphic buttons are those to the top of the sound playing
  219.     queue.  This allow you to perform advanced operations, and
  220.     are only accessible when you are not playing any sounds.  Going
  221.     from left to right, these are:
  222.  
  223.     Button 1 (Arrow pointing from disk to notes)
  224.  
  225.     Allows you to load an album to your queue.  Albums are a
  226.     collection of sound and music files that you may wish to play
  227.     at a later time.  They can be of rather large length (~32k),
  228.     and can contain any combinations of sounds.  Select the directory
  229.     of the album using the directory selection window and the album
  230.     name by the file selection window or the text input bar.  You
  231.     can only load ONE album at a time, and loading albums WILL ERASE
  232.     your current queue!
  233.  
  234.     Button 2 (Arrow pointing from notes to disk)
  235.  
  236.     Allows you to save an album from your queue to disk.  Same
  237.     rules apply as far as selecting the file name.  You will
  238.     be warned if you wish to overwrite an existing album.
  239.  
  240.     Button 3 (Notes and a "1" in a diamond).
  241.     
  242.     Selects a "Header Midi."  A Header Midi is a midi that plays
  243.     before each other midi is executed.  Useful if some midi songs
  244.     do not return your card to its original state, and you have
  245.     a midi that contains specific codes that do revert the card
  246.     back to normal.  Also useful if there is a song that you enjoy
  247.     quite a bit, or if you want a "fanfare" before songs.  This
  248.     Header Midi will be saved to the INI file if you desire (see
  249.     "CONFIGURING MIDI MACHINE").
  250.  
  251. o       Sound Playing Check boxes (to the right of Queued Sounds)
  252.  
  253.     These check boxes allow you to change the order in which
  254.     Sounds are being played.  Simply click on the boxes to
  255.     change the playing direction.
  256.  
  257.     S(h)uffle
  258.     
  259.     Plays the MIDIs in a format similar to a CD player's "Shuffle"
  260.     mode.  This will play all your sound files randomly until every
  261.     song has been played.  Then, the sounds will begin again with
  262.     a new random combination.  For example, if you have in your
  263.     queue the files SOUNDA, SOUNDB, SOUNDC, SOUNDD, the way the
  264.     sounds will be played COULD be like this:
  265.     
  266.     1) SOUNDB    2) SOUNDC    3) SOUNDD    4) SOUNDA
  267.     
  268.     as all sounds have been played, the queue will start over with
  269.     something randomly like:
  270.     
  271.     1) SOUNDD    2) SOUNDB    3) SOUNDA    4) SOUNDC    
  272.  
  273.     ...this will continue until you stop the sound playing by
  274.     pressing "STOP!" or exiting the program by pressing "EXIT."
  275.     This button is only visible when you are in selection,
  276.     not playback, mode.
  277.  
  278.     Ran(d)om
  279.  
  280.     Plays the sound files COMPLETELY randomly, meaning that if
  281.     you are using CONTIN. (continuous) mode you may hear one sound
  282.     twice before hearing all of the others.  Without CONTIN. mode,
  283.     all sounds will play once and playing will stop.
  284.  
  285.     (B)kwrds
  286.  
  287.     Plays the sound files backwards.
  288.  
  289.     C(o)ntin.
  290.  
  291.     Plays the sounds continuously.  This button is only visible
  292.     when you are in selection, not playback, mode.
  293.  
  294. o       Sound Selection Check Boxes
  295.  
  296.     (M)id
  297.  
  298.     Adds .MID (MIDI) sound files to the list of files that can
  299.     be selected (ON as default).
  300.  
  301.     (W)av
  302.  
  303.     Adds .WAV (WAVE) sound files to the list of files that can
  304.     be selected (ON as default).
  305.  
  306. o    Help Bar
  307.  
  308.     This bar displays a line of help on the button or window which
  309.     your mouse pointer is currently over.  This is only applicable 
  310.     on the main screen and not in the configuration area (it CAN be
  311.     turned off...see "Configuring MIDI Machine.")
  312.     
  313. V.    Configuring MIDI Machine
  314.  
  315.     Midi Machine can be setup in many ways, and even more ways
  316.     to make MIDI MACHINE configurable are being planned for
  317.     later versions.
  318.  
  319. o    Visible Configurations
  320.  
  321.     These are configuration items that can be changed without
  322.     editing the MM100.INI file (see below).
  323.  
  324.     Midi Picture    
  325.  
  326.     This pull-down bar allows you to display the animation which
  327.     you want displayed while MIDIs are being played.  There are 9
  328.     separate animations or you can choose <NONE>.  <RANDOM> mode
  329.     plays all of the animations randomly.
  330.  
  331.     WAV Picture
  332.  
  333.     Same as MIDI PICTURE, but corresponds to when WAV files are
  334.     being played.
  335.  
  336.     Show Help Bar
  337.  
  338.     Allows you to allow/disallow the help bar from being displayed.
  339.  
  340.     Show Status Bar
  341.  
  342.     Allows you to allow/disallow the status bar from being
  343.     displayed.
  344.  
  345.     Show Soundname When Minimized
  346.  
  347.     When Midi Machine is minimized, the animation will still play!
  348.     The name of the sound currently played will be displayed under
  349.     the animation when this box is checked.
  350.     
  351.     Save Ini
  352.  
  353.     Saves all information on the setup screen AND the current
  354.     Header Midi into the MM100.INI file.
  355.  
  356.     Revert Ini
  357.  
  358.     Reverts the current configuration to that of MM100.INI.
  359.  
  360.     Exit To Main
  361.  
  362.     Exits back to the main screen.
  363.  
  364. o    .INI Configurations
  365.     
  366.     Midi Machine has a corresponding .INI file, MM100.INI.  Various
  367.     features of the program can be changed in this file with a
  368.     simple TEXT editor (NOTEPAD will do fine).
  369.  
  370.     ShowStatusBar= X
  371.  
  372.     1 = Show Status Bar
  373.     0 = Do Not Show Status Bar
  374.  
  375.     ShowHelpBar= X
  376.  
  377.     1 = Show Help Bar
  378.     0 = Do Not Show Help Bar
  379.  
  380.     ShowSongWhenMinimized= X
  381.  
  382.     1 = Show Sound Name When Minimized
  383.     0 = Do Not Show Sound Name When Minimized
  384.  
  385.     Anim_Mid= X
  386.  
  387.     Number of the MIDI to display when playing
  388.     0   = None
  389.     1-9 = Number of Picture (+1)
  390.     10  = Randomize
  391.  
  392.     Anim_Wav= X
  393.  
  394.     Number of the WAV to display when playing
  395.     0   = None
  396.     1-9 = Number of Picture (+1)
  397.     10  = Randomize
  398.  
  399.     Pic(0-8)= X
  400.  
  401.     Name of the animation to place in picture locations 0-8
  402.     instead of the default animation.  The filenames used
  403.     should be without the .CCC or .CCB extensions (see "EXTRA
  404.     ANIMATIONS").  Leaving the space after the equal sign blank
  405.     will stop Midi Machine from loading an external animation
  406.     file.  The defaults hard-coded into the program are:
  407.  
  408.     0    =    Conductor
  409.     1    =    Ear
  410.     2    =    Excel Progs Logo
  411.     3    =    Wave
  412.     4    =    Oscilloscope
  413.     5    =    Dancing Notes
  414.     6    =    Dancing Disk Man
  415.     7    =    Feel The Music
  416.     8    =    Fractal 1
  417.  
  418.     [NOTE:  Midi Machine MAY have been distributed with extra
  419.     icon sets, and the icons you get when first running this
  420.     program MAY be different.  If that is the case, you may
  421.     wish to examing the INI file.]
  422.  
  423.     HeaderMidi= X
  424.  
  425.     Name of the Header Midi (Midi to play before others).
  426.     Leaving the space after the equal sign blank will stop
  427.     Midi Machine from playing a header midi.
  428.  
  429. VI.    Extra Animations
  430.  
  431.     Midi Machine support external animation files (.CCB extension).
  432.     These animations currently support 4 icons (more will be
  433.     supported in the future).  Each animation comes with a
  434.     corresponding description file (.CCC extension), which is of
  435.     this format (everything    that is to be replaced by other text
  436.     is in quotes).
  437.  
  438. ~~~~~~This is the Beginning of the file~~~~~~~~~~~~~~~~~~~~~~~~
  439. "short icon description"
  440.  
  441. [Date]:"icon creation date"
  442. [By]:"icon creator(s)"
  443. [Included]:"zip file or icon pack where animation was found"
  444.  
  445. [Long Description]
  446.  
  447. "description of icon."
  448. ---------------------------------------------------------------
  449. ~~~~~~This is the End of the file~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  450.  
  451.     REGISTERED users may send in the above information and 4
  452.     icons and shall receive an animated icon in return (note
  453.     that if you do this via Internet I must have an e-mail
  454.     address, and if you do this via mail I MUST have a disk
  455.     and self-address stamped disk mailer!  I also need to know
  456.     whether or not the animated icon can be distributed freely).
  457.  
  458.     REGISTERED users may do this only with public domain icons
  459.     which do not represent a company, group,..etc.  The limit is
  460.     15 icons per registration, but special considerations may
  461.     apply for other cases (especially if you're letting the
  462.     animations be distributed freely).  Contact me if you
  463.     need information.
  464.  
  465.     For other cases (including making animations of business
  466.     logos and having me draw you an animation)...leave me mail
  467.     and we'll talk.
  468.  
  469. VII.    Support Info.
  470.  
  471. If you notice any errors, please let me know.  I can be contacted
  472. by the following ways:
  473.  
  474. 1)      SASE at the Excel Progs address.
  475. 2)      E-Mail on The Other World BBS as Jman.
  476. 3)      Internet E-Mail:  admalek@sacam.oren.ortn.edu
  477.  
  478. The only errors noticed (that haven't been corrected) is that the
  479. program will hang on a .MID that your current drivers can't support.
  480. If pressing the NEXT button does not work, pressing STOP and START
  481. should re-start the playing.  Excel Progs is currently looking into
  482. this.  There should be a new option whether to either display multimedia
  483. errors or simply skip the offending file(s) within the next two releases.
  484.  
  485. If Midi Machine attempts to load a file in the queue that is not
  486. present, or if it attempts to load a .WAV that isn't supported (ex. trying
  487. to play a 16-bit wav on an 8-bit card), it will skip on to the next file.
  488. An option to halt the sound playing with an error is considered for the
  489. future.
  490.  
  491. VIII.    Registration
  492.  
  493. Registration is $15.00, which will give you the current release of Midi
  494. Machine (up to version 1.5 - further versions MAY cost more) with your
  495. name on the title bar and in the ABOUT box (nothing profane, please!) 
  496. Company/government/group registrations are as follows:
  497.  
  498. 1-10 licenses   / $14 @
  499. 11-25  "    "   / $13 @
  500. 26-49  "    "   / $12 @
  501. 50 & up         / $10 @
  502.  
  503. Mail the check or money order (NO CASH), your preferred disk format
  504. (3.5 or 5.25 double density), and your name or company name to:
  505.  
  506. Excel Progs
  507. re:  Midi Machine Registration
  508. c/o Andrew Malek
  509. 434 Gallaher View Rd Apt. 60
  510. Knoxville, TN  37919
  511.  
  512. (Note: TN Residents include 8.25% sales tax).
  513.  
  514. IX.    Revisions
  515.  
  516. V0.7    First Beta Version (For TOW Development beta-testing)
  517.  
  518. V0.75   Misc. Features
  519.  
  520.     Added a minimum button.
  521.     The text colors were changed from blue to yellow, letting
  522.       the text stand out more.
  523.     Altered the text in the "About" box slightly.
  524.     You can now rename one file at a time (fixed), and it
  525.       displays the name/size of the file in the box.
  526.     Traps any errors in rename procedure.
  527.     Ability to delete multiple files.
  528.     Allows canceling of delete procedure.
  529.     Traps any error in delete procedure.
  530.     Able to play MIDIs in continuous mode.
  531.     In the title bar, as well as when the icon is minimized,
  532.       the text is changed to the midi name when playing, or
  533.       "Paused..." when paused.
  534.  
  535. V0.78   Graphics/More
  536.  
  537.     Minor Bug Fixes
  538.     Added Setup Screen
  539.     Added moving picture ability when midis are being played
  540.     Created "Conductor," "Music Notes," "Feel the Music"
  541.       animation sequences
  542.     
  543. V0.83   WAV Support, Graphics/More
  544.  
  545.     Minor Bug Fixes
  546.     Stopped "flicker" when changing icons in setup mode when
  547.       playing midis.
  548.     Added WAV support
  549.     Added WAV icon support.
  550.     Created "Ear," "Wave," "Oscil" animations.
  551.     Added new feature of "Smart-Renaming"... wav files
  552.       will add .wav extension if left off, mid files will
  553.       add .mid extension if left off.
  554.  
  555. V0.86   New About Box/More
  556.  
  557.     Bug Fixes
  558.     Renaming a file to itself will not display error
  559.     New "About" box
  560.     New "About" and "Setup" box formats...windows stay on screen until
  561.       you want them to be removed.  You can have all three windows
  562.       on at one time.
  563.  
  564. V0.88   Bug Fixes/Speed Improvements
  565.  
  566.     Bug Fixes
  567.     Increased speed with animated icons.
  568.     When Midi Machine is minimized, the graphics will not
  569.       move...speed increase.
  570.  
  571. V0.89   First Official Beta Release
  572.  
  573.     Bug Fixes
  574.  
  575. V0.90   Interim Release
  576.  
  577.     Added ability to select only .WAV / .MID files or both
  578.       when adding files to the queue.
  579.     Animated picture shows even when program is minimized.
  580.  
  581. V1.00    First Official Standard Release
  582.  
  583.     Bug Fixes
  584.     9 default animations are installed, and WAV and MID files
  585.       may use any/all of them.
  586.     External animation support, with animation descriptions.
  587.     Random animation play support.
  588.     Shuffle play support.
  589.     Load/Save Album support.
  590.     Mouse-Pointer display help in Help Bar (configurable).
  591.     Info Bar to display file information.
  592.     .INI file support.
  593.     Allows INFO button to be used during sound playing.
  594.     Sound file information displayed in separate Info Bar.
  595.     Added feature to turn-off display of sound name when
  596.       minimizing icon.
  597.     "Header Midi" support.
  598.     Many other function/cosmetic changes not mentioned here.
  599.  
  600. X.    Warranty/Disclaimer/Thanks
  601.  
  602. EVERY EFFORT WAS MADE BY EXCEL PROGS/TOW DEVELOPMENT TO ENSURE THE
  603. QUALITY OF THE PRODUCT AND EVERY ATTEMPT WAS MADE TO MAKE THE
  604. PROGRAM AS ERROR-FREE AS POSSIBLE.  HOWEVER, NEITHER EXCEL PROGS, 
  605. TOW DEVELOPMENT, ITS EMPLOYEES, SUPERVISORS,..ETC, TAKE ANY
  606. RESPONSIBILITY FOR THE OUTPUT OF THIS PROGRAM.  YOU, THE USER, TAKE
  607. FULL RESPONSIBILITY FOR THE USAGE OF THIS SOFTWARE.
  608.  
  609. Microsoft, Windows, are registered trademarks of Microsoft Corp.
  610. All trademarks are the property of their respective companies.
  611. Midi Machine (c) 1994 Excel Progs, All Right Reserved
  612.  
  613. Thanks to everyone on the newsgroup ALT.BINARIES.SOUND.MIDI and others
  614. who have beta-tested this program, giving criticisms and ideas. I
  615. definitely appreciate the time you took to examine the beta version
  616. and give ideas for this full release.